package com.pokermind.common.web;

import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.annotation.JsonInclude;

/**
 * 统一API响应封装类 - 标准格式
 * 使用标准的 code、message、data 三字段格式
 *
 * @author PokerMind Team
 */
@JsonInclude(JsonInclude.Include.NON_NULL)
public class ApiResponse<T> {
    
    private String code;
    private String message;
    private T data;
    
    // === 构造方法 ===
    
    private ApiResponse(String code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
    }
    
    // === 成功响应静态方法 ===
    
    /**
     * 创建成功响应
     */
    public static <T> ApiResponse<T> success(T data) {
        return new ApiResponse<>("0000", "success", data);
    }
    
    /**
     * 创建成功响应（带自定义消息）
     */
    public static <T> ApiResponse<T> success(T data, String message) {
        return new ApiResponse<>("0000", message, data);
    }
    
    /**
     * 创建成功响应（无数据）
     */
    public static ApiResponse<Void> success() {
        return new ApiResponse<>("0000", "success", null);
    }
    
    /**
     * 创建成功响应（无数据，自定义消息）
     */
    public static ApiResponse<Void> successNoContent() {
        return new ApiResponse<>("0000", "success", null);
    }
    
    // === 失败响应静态方法 ===
    
    /**
     * 创建失败响应
     */
    public static <T> ApiResponse<T> error(String code, String message) {
        return new ApiResponse<>(code, message, null);
    }
    
    // === 业务专用方法 ===
    
    /**
     * 创建手牌创建成功响应
     */
    public static <T> ApiResponse<T> handCreated(T data) {
        return new ApiResponse<>("0000", "hand created", data);
    }
    
    /**
     * 创建手牌操作成功响应
     */
    public static <T> ApiResponse<T> handOperationSuccess(T data, String operation) {
        return new ApiResponse<>("0000", operation + " completed", data);
    }
    
    /**
     * 创建AI分析成功响应
     */
    public static <T> ApiResponse<T> aiAnalysisSuccess(T data) {
        return new ApiResponse<>("0000", "ai analysis completed", data);
    }
    
    /**
     * 创建AI分析错误响应
     */
    public static <T> ApiResponse<T> aiAnalysisError(String message, T data) {
        return new ApiResponse<>("4000", message, data);
    }
    
    // === Getter和Setter ===
    
    public String getCode() {
        return code;
    }
    
    public void setCode(String code) {
        this.code = code;
    }
    
    public String getMessage() {
        return message;
    }
    
    public void setMessage(String message) {
        this.message = message;
    }
    
    public T getData() {
        return data;
    }
    
    public void setData(T data) {
        this.data = data;
    }
    
    // === 兼容性方法 ===
    
    /**
     * 兼容性方法 - 判断是否成功（0000码表示成功）
     */
    @JsonIgnore
    public boolean isSuccess() {
        return "0000".equals(code);
    }
    
    /**
     * 兼容性方法 - 获取错误信息（非0000码时返回错误信息）
     */
    @JsonIgnore
    public ErrorInfo getError() {
        if (!"0000".equals(code)) {
            return new ErrorInfo(code, message);
        }
        return null;
    }
    
    // === 兼容性内部类 ===
    
    /**
     * 错误信息兼容类
     */
    public static class ErrorInfo {
        private String code;
        private String message;
        
        public ErrorInfo(String code, String message) {
            this.code = code;
            this.message = message;
        }
        
        public String getCode() { return code; }
        public String getMessage() { return message; }
    }
}
